www.gusucode.com > Piwik 网站流量统计系统 v2.9.1PHP源码程序 > Piwik 网站流量统计系统 v2.9.1/piwik/piwik/plugins/ExamplePlugin/Widgets.php
<?php /** * Piwik - free/libre analytics platform * * @link http://piwik.org * @license http://www.gnu.org/licenses/gpl-3.0.html GPL v3 or later * */ namespace Piwik\Plugins\ExamplePlugin; use Piwik\View; use Piwik\WidgetsList; /** * This class allows you to add your own widgets to the Piwik platform. In case you want to remove widgets from another * plugin please have a look at the "configureWidgetsList()" method. * To configure a widget simply call the corresponding methods as described in the API-Reference: * http://developer.piwik.org/api-reference/Piwik/Plugin\Widgets */ class Widgets extends \Piwik\Plugin\Widgets { /** * Here you can define the category the widget belongs to. You can reuse any existing widget category or define * your own category. * @var string */ protected $category = 'Example Category'; /** * Here you can add one or multiple widgets. You can add a widget by calling the method "addWidget()" and pass the * name of the widget as well as a method name that should be called to render the widget. The method can be * defined either directly here in this widget class or in the controller in case you want to reuse the same action * for instance in the menu etc. */ protected function init() { // $this->addWidget('Example Widget Name', $method = 'myExampleWidget'); // $this->addWidget('Example Widget 2', $method = 'myExampleWidget', $params = array('myparam' => 'myvalue')); } /** * This method renders a widget as defined in "init()". It's on you how to generate the content of the * widget. As long as you return a string everything is fine. You can use for instance a "Piwik\View" to render a * twig template. In such a case don't forget to create a twig template (eg. myViewTemplate.twig) in the * "templates" directory of your plugin. * * @return string */ public function myExampleWidget() { // $view = new View('@ExamplePlugin/myViewTemplate'); // return $view->render(); return 'My Widget Text'; } /** * Here you can remove any widgets defined by any plugin. * * @param WidgetsList $widgetsList */ public function configureWidgetsList(WidgetsList $widgetsList) { // $widgetsList->remove('NameOfWidgetCategory'); // will remove all widgets having this category // $widgetsList->remove('NameOfWidgetCategory', 'Widget name'); // will only remove a specific widget } }